home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / utils / viewers / streader.lzh / STREADER.DOC < prev    next >
Text File  |  1990-06-22  |  29KB  |  485 lines
  1.  
  2.                   THIS IS THE DOCUMENT FILE FOR ST READER.
  3.                THE COMPLETE ST READER PACKAGE SHOULD CONTAIN  
  4.              STREADER.DOC, STREADER.LST, and the STREADER.PRG
  5.        THESE FILES MAY BE GIVEN (NOT SOLD), COPIED, AND PASSED AROUND
  6.               GENERALLY, PROVIDED ALL THESE FILES ARE INCLUDED.
  7.                   PLACED IN THE PUBLIC DOMAIN JUNE 15, 1990
  8.  
  9.     p********************************************************************q
  10.     p*                                                                  *q
  11.     p*                                                                  *q
  12.     p*                         S T  R E A D E R                         *q
  13.     p*                                                                  *q
  14.     p*                           Version 3.10                           *q
  15.     p*                                                                  *q
  16.     p*                                                                  *q
  17.     p*            © 1990 By Sterling K. Webb, SKWare One, Inc.          *q
  18.     p*                P. O. Box 277, Bunker Hill, IL 62014              *q
  19.     p*                                                                  *q
  20.     p*                                                                  *q
  21.     p********************************************************************q
  22.  
  23.  
  24.  
  25.         The ST READER is a text viewing program which can be used both
  26.     with installed application filetypes (that means that ST Reader will
  27.     be called when you double-click on a file of that type from the
  28.     Desktop) or as a stand-alone program called directly by double-
  29.     clicking on STREADER.PRG. 
  30.         ST READER will display text files in 80 columns no matter what
  31.     resolution you're operating in, even low (by jumping into medium
  32.     resolution and back to low again when you exit.)
  33.         The length of file ST READER can load into memory is limited
  34.     only by how much memory is available (maximum file length is roughly
  35.     half the available memory). 
  36.         To view document files from the Desktop, highlight the ST READER
  37.     icon by clicking on it, then select the "Install Application" choice
  38.     from the Options Menu.  Enter the extent of the text files you wish
  39.     to view (such as .DOC, .TXT, .MSS, .LST, and so forth).  Then, when
  40.     you double-click on a file with those extents, ST READER will be
  41.     called to display the file for you.  The application filetype will
  42.     be saved if you save the Desktop after installation. 
  43.         If you have not installed an application filetype for ST READER,
  44.     a Fileselect appears when you start the ST READER from the Desktop. 
  45.     You will first be given the opportunity to select the drive from
  46.     which you wish to read files, to set the path for those files, and
  47.     to specify a mask for filetypes.  (These can be changed later, at
  48.     any time you wish; see below.)
  49.         When the file is displayed, you will notice that the bottom or
  50.     memo line of the screen is printed in reverse video.  Pressing the
  51.     <Esc> key will advance you to a new memo line.  The memo lines
  52.     contain a summary of all of ST READER's commands.  Pressing the
  53.     <Tab> key moves you backward through the sequence of memo lines. 
  54.         You can scroll through a text using the following keystroke
  55.     commands: The Up-Arrow and Down-Arrow keys page-flip; the Left-Arrow
  56.     and Right-Arrow keys smooth-scroll up and down.  You can jump to the
  57.     start of a document with the <CLR/HOME> key, or jump to the end of
  58.     the document with CNTL+<Clr/Home> (this means: hold down the CONTROL
  59.     key while pressing <Clr/Home>).  You can exit the display with the
  60.     <UNDO> key.  You will be given the option of selecting another file
  61.     to read or avoiding an exit to GEM. 
  62.         You can also page forwards and backwards by half-pages using
  63.     CNTL+(Left-Arrow) and CNTL+<Right-Arrow> keys.  Pressing one of the
  64.     number keys (from 1 to 9) will repeat the previous document movement
  65.     command that many times.  For example, pressing Down-Arrow and then
  66.     the <9> key will advance you 10 pages in the document. 
  67.         If you load a .DOC file that turns out to be a 1stWord file,
  68.     no problem; ST READER will convert 1stWord files to Ascii text. 
  69.     Just press the <Help> key.  (This converts the entire file, not just
  70.     the displayed screen.) Conversely, you can convert a Ascii file into
  71.     the 1stWord format by pressing the CNTL+<Help> key.  This conversion
  72.     is to text that matches 1stWord's definition of a Word-Processing
  73.     text, so that 1stWord will perform all of its "WP" operations on the
  74.     text, such as reformat or justify paragraphs. Tabular matter is
  75.     preserved intact.
  76.         Such converted files (or any file or portion of a file, for
  77.     that matter) can be saved by CNTL+<S> under whatever filename you
  78.     select.  The file to be saved can consist of the complete file as
  79.     loaded or only a portion of the file, using the same block commands
  80.     as the print option (which will be explained in the next paragraph). 
  81.          CNTL+<P> will send the file you are viewing to your printer. 
  82.     ST READER will give you an alert to set the Top-of-Form on your
  83.     printer and will check to see if the printer is on-line before
  84.     printing the file.  The lines of text to be printed are highlighted
  85.     (with yellow or blue on a color monitor and a dot screen line in
  86.     monochrome).  Lines are advanced off the screen when the screen is
  87.     scrollable or un-highlighted as each line is sent to the printer (or
  88.     saved).  You will be querried as to whether or not to skip over the
  89.     form perforations (the interval is fixed at a three-line top and
  90.     bottom margin with 60 lines to the page). 
  91.          You also have the option of printing (or saving) only a
  92.     portion of the file as a specific block from the document.  When you
  93.     choose this option a marker (a line or space printed in reverse
  94.     video) will appear at the top of the screen.  This marker can be
  95.     moved down the screen by CNTL+<D> and up the screen by CNTL+<U>. 
  96.     When you shift the screen using the cursor arrow keys, the marker
  97.     line advances with you, maintaining its screen position as the text
  98.     moves. 
  99.         When you have placed the marker on the line that you wish to
  100.     specify as the beginning of the block, press CNTL+<A>.  Move to the
  101.     screen where the block ends and position the marker on the line you
  102.     wish to be the LAST LINE TO BE PRINTED (not the end of the block!)
  103.     and press CNTL+<Z>.  (That is, in ST READER, the marks are included
  104.     in the block.) Marking the start of a block produces a one-bell
  105.     ring; marking the last line of a block produces a two-bell ring. 
  106.         If you create an inconsistant marking (like having the end
  107.     before the beginning), all lines will be unmarked and you will be
  108.     asked to repeat the block-marking operation from scratch.  The
  109.     printing operation, once begun, can be ABORTed at any time by
  110.     pressing CNTL+<P> again. 
  111.         The selected drive, path, and mask can be changed at any time by
  112.     pressing CNTL+<R>.  First, an alert will inform you of the current
  113.     selection of drive (A:, B:, etc.), the current selection for path
  114.     (the open directory on that drive, like "\TEXT" or "\DOCUMENT" or
  115.     the root directory which is indicated by "\"), and the "mask" which
  116.     indicates which filetypes to list in the Fileselect (like "*.*" for
  117.     all files, or "*.TXT" for all files with the extent of ".TXT").  The
  118.     "*" means all possible terms of whatever length; "?" means any
  119.     single letter.  For example, "*.P??" would search for all .PRG files
  120.     and all Degas pictures and any files whose extent starts with the
  121.     letter "P."
  122.         If you click on "OK" in the drive alert, no changes are made; if
  123.     you select "Reset," the ledger line at the bottom of the screen
  124.     changes to let you alter the drive, path and mask.  Use <Backspace>
  125.     to erase characters and <Esc> to clea